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<?xml version="1.0" encoding= "UTF- 8 " ?> 
<SesaIntegrationData xmlns:xsi= 

" ht tp : //www . w3 . org/2 0 0 1/XMLSchema- ins tance " 
xsi :noNamespaceSchemaLocation="NabooBase .xsd" > 
<SesaProductData> 

<Version>l . 00</Version> 
<Author>ABC< /Author > 
<Revision>0 . 01</Revision> 
<RevDate>Feb 15 2003</RevDate> 
< Product > 

<!-- Simple Sample Product --> 
<!-- Product ID 3001 ==> Numbering 
Range [30,010,000 - 300,019,999] 
-<Product Id= n 3 001 !l > 

<Version>4 . 0</Version> 

< Vendor >Symantec Corporation< /Vendor > 
< SKUNumber > 12 3 4 < / SKUNumber > 
<Caption>Sample Product</Caption> 
<Description>Simple Sample Product 

for NIK </Description> 
<Name>Sample Product</Name> 
<DisplayName Langld="10001" > 

Sample</DisplayName> 
< Event FamilyMember ship Id= 11 90000 " /> 
r<DataDef inition> 

!-- Software Feature Ids 

30, 010, 101-30, 010, 999 --> 
- <Sof twareFeature Id="30010101 n > 
<Caption>Sample Software 

Feature </Caption> 
<Description>Sample Software 
42003 I Feature</Description> 
* <Name>30010101</Name> 

<DisplayName Langld= " 10001 " > 
Sample Software Feature 
</DisplayName> 
< Fea t ureRol e >SESA_LOGGING 
</FeatureRole> 
</Sof twareFeature > 
</DataDef inition> 
</ Product > 
</SesaProductData> 
</SesaIntegrationData> 
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package com.symantec.management.example; 

import java.io.*; 
import java.util.*; 
importjava.net.*; 

import org.snia.wbem.cim.CIMException; 
import org.snia.wbem.cim.CIMNameSpace; 
import org.snia.wbem.cim.CIMObjectPath; 
import org.snia.wbem.cim.CIMValue; 
import org.snia.wbem.client.CIMOMHandle; 
import org.snia.wbem.client.CIMClient; 

import com.symantec.management.providers.SESAProvider; 
import com.symantec.management.providers.SymcObject; 
import com.symantec.management.providers.SESAException; 

/** example of the Agent/Provider extension interface 
*/ 

public class ExampleProvider extends SESAProvider 
{ 

// product and feature IDs for the advanced sample 

public final int ADV_SAMPLE_APP J>RODUCT JD = 3002; 

public final int ADVSAMPLEAPPJFEATUREJOD = 30020101 ; 

// constants for the config properties 

public final String CFGPROP_POLLTIME = "PollTime" ; 

public final String PROVIDERNAME = 

"Symc_ExampleProvider"; 

// the local cache for your provider's configuration - name should be all lower case 
private final String CONFIG_FILE_NAME = "exampleprovider.cfg"; 

private Properties m_props = null;// holds the config properties 

private CIMObjectPath m_cimPath = null;// object for the Example 
Provider 

private CIMClient m_cimClient = null;// communicate with the 
CIMOM 

public ExampleProviderO 
{ 

System.out.println( M — inside the ExampleProviderO constructor"); 

} 

/* perform initialization of the provider<p> 

Any initialization should be done in here. It is not necessary to request 
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* configurations from the Config Provider, as those are retrieved automatically 

* and sent to applyConfigO- 
*/ 

public void initialize(CIMOMHandle ch) throws CIMException 
{ 

System.out.println("\n***inside the Example Provider !\n"); 

// Any threads to be used should be created in here 

// Threads should be "daemon" so that the shutdown does not 

// have to wait on them too long. 

try 
{ 

loadConfigFile(); 

} 

catch (CIMException e) 

{ 

System.out.println("Could not load example provider's configuration 

file."); 

} 

// There are other methods available in the Config Provider to get information 

// about the machine and the Management Server. These are: 

// getMachineldO - the machine id from the bootstrap process 

// getDB() - get the DN, as used in the Directory 

// getDomainO - get the Domain that this machine was bootstrapped into 

// getOrgUnitO - get the OrgUnit the machine was bootstrapped into 

// getManagementServer() - returns a String for the URL to the Management Server 

// getManagementServerAddressO - returns the IP address of the Management Server 

// getManagementServerPortQ - returns the port the Management Server listens on 

// getSecManagementServerQ - returns a String for the URL to the Secondary 

Management Server 

// getSecManagementServerAddress() - returns the IP address of the Secondary 
Management Server 

// getSecManagementServerPort() - returns the port the Secondary Management 
Server listens on 

// getUseSSLQ - returns true or false, whether or not to use SSL 

// There are also two more methods to retrieve configuration: 

// getConfig(int Productld, int Featureld) 

// getConfig(int Productld, int Featurelds[]) 

// These methods both retrieve a String which contains the entire set of properties from 

// the Directory. The method illustrated below retrieves the same information, but the 
data 

// is parsed for you and returned in a HashMap that looks something like this: 

// see the ConfigParser class for a description of what the HashMap returned from 
// getConfigProperties looks like 
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/** shut down the provider 
*/ 

public void cleanupO throws CIMException 
{ 

// destroy any threads created in initialize() 

} 



/** get the Service object that relates to this Provider 
* @return Service 
*/ 

public SymcObject getServiceO 
{ 

try 
{ 

if (m_Service = null) 
{ 

// the file name referenced "ExampleProvider.svc" can be in 

mixed case 

// as the constructor translates all file names to lower case. 
// The physical file on disk must be in lower case (enforced by 

the Makefile) 

m_Service = new SymcObject("SymcjService", 

"ExamplePro vider . s vc "); 

} 

} 

catch (SESAException se) 
{ 

se.printStackTrace(); 
return (mjService); 

} 

/** the CIM invokeMethod call 
*/ 

public CIMValue invokeMethod(CIMObjectPath op, String name, Vector in, Vector 

out) 

throws CIMException 

{ 

System.out.println( M ExampleProvider.invokeMethod( ,,, + name + "')"); 
CIMValue ret = new CIMValue( ,, unrecognized method + name + ""'); 
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if (name.equalsIgnoreCase( n getconfigdata H )) 

ret = getConfigData(in, out); 
else if (name.equalsIgno^eCase( f, getconflgp^ope^ty ,, )) 

ret = getConfigProperty(in, out); 

return (ret); 

} 



/** obtains all config settings for the application 
*/ 

public CIMValue getConfigData(Vector in, Vector out) 
{ 

if (m_props = null) 

return (new CIMValue("")); 

String sRet = ""; 

Enumeration enum = m__props.keys(); 
while (enum.hasMoreElements()) 
{ 

String sKey = (String) enum.nextElement(); 
String sVal = (String) m_props.get(sKey); 
if(sVal !=null) 

sRet += sKey + "=" + sVal + "\n"; 

} 

if(sRet.length() = 0) 

sRet = "key=value\n"; 

System.out.println( H \n*****Returning config data: + sRet + ,,,M ); 
return (new CIMValue(sRet)); 

} 

/** obtains a specific, named config property 
*/ 

public CIMValue getConfigProperty(Vector in, Vector out) 

if (m_props = null) 

return (new dMValue("")); 

String sParam = null; 
try 

{ 

sParam = getParameterString(in, "propName"); 
catch (SESAException se) 
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return (new CIMValue("")); 

} 

if (sParam = null) 

return (new CIMValueC"")); 

// Looks in the private cache of properties to retrieve the value. 
String sVal = (String) m_props.get(sParam); 
if(sVal = null) 
sVal = ""; 

if(sVal.length() = 0) 

sVal = sParam + ".value"; 

System.out.println("\n***Returning config property m + sParam + = f " + 

sVal + *""); 

return (new CIMValue(sVal)); 



/** Used for sending messages between Providers.<P> 

* This method is called from another Provider to inform this Provider of a specific 

* event. The string contains information that can be parsed. 

* @param msg The String representing the message. 
*/ 

public void sendMessage(String msg) 

{ 
} 

/** get the name of the Provider 

* @return a string representing the name of this Provider 
*/ 

public String getNameQ 
{ 

return (PROVIDER__NAME); 

} 



/** Informs the Provider of an updated configuration.<P> 

* This is called from the Configuration Provider when there is a new 

* configuration that the Provider should use. 

* @param newConfigs A HashMap representing the configuration properties that 

* the Provider should use from this point forward. See the ConfigParser 

* class for a description of the contents of the HashMap 
*/ 

public void applyConfig(HashMap newConfigs) 
{ 
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// Get the properties that we are interested in from the entire set. The entire 

set includes 

// all products and features. We are interested only in our own application. 
Properties newProps = getCfgPropertySet(newConfigs, 
ADVSAMPLE_APP_FEATURE_ID, "SampleApplication"); 
if (newProps = null) 
{ 

System.out.println("no properties found for SWF " + 

getSoftwareFeatureldO); 

return; 

} 

// Private cache of properties. 
m_props = newProps; 

String sVal = (String) m_jprops.get(CFGPROP_POLLTIME); 

if(sVal !=null) 

{ 

try 

{ 

// Set the poll time in the instance so that the application can use the standard 

CIM 

// call getProperty to retrieve it. This also allows the poll time to become 

part of 

// the application's set of state variables. You would put a property here only 

if you 

// want it accessible through CIM. If not, keep it only in the private cache. 
createCEVIClientO; 

m_cimClient.setProperty( m cimPath, "ProviderPollTime", 

new CIMValue(sVal) ); 

} 

catch (CIMException ce) 

{ 

System.out.println("\n»»> Error setting property 
ProviderPollTime in instance\n" ); 

System.out.println( ce.toString() ); 

> 

// update the local configuration file from the HashMap 
File fiConfig = new File(CONFIG_FILE_N AME) ; 

FileOutputStream os = null; 

try 
{ 

os = new FileOutputStream(fiConfig); 
m_props.store(os, null); 

} 
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catch (FileNotFoundException fiif) 

{ 
} 

catch (IOException ioe) 

{ 
} 

if (os != null) 
try 

{ 

os.closeO; 

catch (IOException ioe) 

{ 

} 

// At this point the provider could communicate with its application to push the new 
configuration 

// to the application. Alternatively, the application could poll for changes to the 
configuration 

// file created above and read its configuration from the file. 

// Check to see if the advanced sample application is listening on the pre-defined port 
try 

{ 

// The port is defined in the advanced sample app. 
Socket sock = new Socket(" 127.0.0.1", 4990); 

if (sock != null) 
{ 

// If we're able to get a connection, then the advanced sample app is 

running 

// and waiting for a connection on localhost:4990. Attempt to write 

out the data. 

// The data will be the value that was assigned to "ProviderPollTime". 
// Note that the data sent can also be custom xml settings that will get 

parsed 

// by the application. 

BufferedOutputStream ostream = new 
BufferedOutputStream(sock.getOutputStreamO); 

ostream.write(sVal.getBytes()); 

// Cleanup 

ostream.close(); 

sock.close(); 

} 

} 
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catch (UnknownHostException e) 



catch (IOException e) 



catch (Exception e) 



} 



/** get the Product ID for this Provider 

* @return an integer representing the Product ID that this Provider is associated 

with. 

*/ 

public int getProductldQ 

{ 

return (ADV_SAMPLE_APP_PRODUCT_ID); 

} 



/** get the Software Feature ID 

* @return an integer representing the Software Feature ID that this Provider is 

* associtated with, or 0 if the Provider is not associated with a 

specific 

* feature ID. 
*/ 

public int getSoftwareFeatureId() 

{ 

return (ADV_SAMPLE_APP_FEATURE_ID); 

} 



/** load the configuration file from disk 
*/ 

private void loadConfigFileO throws CIMException 
{ 

File fiConfig = new File(CONFIG_FILE_NAME); 
if (IfiConfig.existsO) 

throw new CIMException("Symc_ExampleProvider: cannot find 
config file "' + CONFIG_FILE_NAME + ); 

m_props = new PropertiesO; 
try 

{ 

m_props.load(new FilelnputStream(fiConfig)); 

} 
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catch (FileNotFoundException fhf) 
{ 

throw new CIMException("Symc_ExampleProvider: cannot load 
config file '" + CONFIG_FILE_NAME + '""); 
} 

catch (IOException ioe) 

{ 

throw new CIMException("Symc_ExampleProvider: error reading 

configuration file"); 

> 

private void createCIMClient() throws CIMException 
{ 

if (m_cimPath = null) 
{ 

m_cimPath = new CIMObjectPath( PROVIDER NAME ); 
m_cimPath.addKey( "CreationClassName", new CIMValue( 

"Symc_Service" ) ); 

m_cimPath.addKey( "Name", new CEvlValue( 
"30020101.exampleprovider" ) ); 

m_cimPath.addKey( "SystemCreationClassName", new CIMValue( 
"Symc_ComputerSystem" ) ); 

m_cimPath.addKey( "SystemName", new CIMValue( "localhost" ) ); 

} 

if (m_cimClient = null) 
{ 

CIMNameSpace ens = new CIMNanieSpace( "localhost", "root" ); 
m_cimClient = new ClMClient( ens, null, null, CIMClient.LOCAL ); 

} 

} 

} 
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